release v0.2.22 - #146

What changed

Release v0.2.22. Version bumped, and the in-repo changelog mirror is gone.

1. Version bump + doc refs — package.json / package-lock.json → 0.2.22; every v0.2.21 reference in README.md, README.en.md, docs/README.md, docs/index.md bumped. docs/presets-design.md carried a "Phase 1 尚未合入 main，main = bb9f2f6（release v0.2.21）" note describing pre-merge state — it now reads as history, since Phase 1 shipped in this release.

2. Drop the in-repo changelog mirror. docs/README.md carried a hand-maintained copy of every release note (v0.2.21 down to v0.1.0) — the same text that lives on the GitHub Releases page. Keeping it meant writing release notes twice on every release, and the two drifted apart. The section is now a one-line pointer to GitHub Releases. (README.md / README.en.md never had a changelog section, so there was nothing to delete there — their only version references are the beta notice and the git-install example.)

3. Fixed a pre-existing formatting bug found while doing (2): in docs/README.md the | [Media visibility design] … | table row (added by (feat) image and file blocks stay visible to the engine — placeholder projection + host-meter media price (#117) #144) had been glued onto the ## 📦 Releases heading line, so Markdown rendered the row as part of the heading and the design doc was missing from the Documents table. The row is back inside the table.

Verification

• Every edit was applied by an anchor script that asserts each anchor matches exactly once; it aborts before writing anything on a mismatch.
• grep -rn "0\.2\.21" --include=*.md (excluding node_modules/dist/worktrees) leaves exactly one hit: the intentional historical note in docs/presets-design.md.
• No src/ changes: this branch is main @ 818a9f1 (pre-flight green: typecheck clean, 327/327 tests, build clean) plus docs and the version bump, so runtime behavior is untouched. CI runs the full suite on this PR.

Release notes preview (to be posted on the GitHub Release page)

v0.2.22 — 14 substantive commits since v0.2.21: 4 features, 1 kernel upgrade, 8 fixes, 1 test guard.

Features

• image/file blocks stay visible to the engine — deterministic placeholder projection, host-meter media price, [+N images] range-row marker ([multimodal] image block 在 ACP 投影层完全不可见:同一份 acp_status 两套标尺、range 表对图片区间记 0 token、图片-only 事件无 bare ref 且不受内核保护 #117 / (feat) image and file blocks stay visible to the engine — placeholder projection + host-meter media price (#117) #144)
• hot-reload engine settings via ~/.dsh/settings.yaml + /acp config ((feat) hot-reload engine settings via settings.yaml + /acp config (phase 1; supersedes #76) #130, phase 1 of 运行时设置集成（阶段一）：接入宿主 ctx.settings —— settings.yaml 热生效 + /acp config 命令 #75)
• frame model-written summaries, record verifiedReadings, trim nudge bodies ((feat) frame model-written summaries, record verified readings, slim nudges (drop unchanged-injection elision) #143)
• one-word nudge presets via config.preset — five tiers ((feat) one-word nudge presets via config.preset (five tiers) #129)

Fixes

• stop compressing injected AGENTS.md rows — breaks the compress → re-inject loop, and the real last user turn stays protected ((fix) stop compressing injected AGENTS.md rows — break the compress→re-inject loop and protect the real last user turn #93)
• page large-block decompress output with offset/limit ((fix) page large-block decompress output with offset/limit so one recovery can't flood or get silently trimmed #118)
• bound per-session kernel state and nudge-dedup caches with LRU eviction ((fix) bound per-session kernel-state and nudge-dedup caches with LRU eviction #121)
• cache the search ledger and corpus per log snapshot — 20-minute searches become sub-second ((fix) search_context: cache the block ledger and search corpus per log snapshot — 20-minute searches become sub-second #134)
• read the output-cap reservation from the live request route after a model switch ((fix) 切模型后 output cap 改从 session.requestContext 取实时路由 #135)
• emit the renamed replace-op dialect for dsh-session 0.1.5+ and floor the peer range at 0.1.5 ((fix) emit the renamed replace-op dialect for dsh-session 0.1.5+ and floor the peer range at 0.1.5 #137, issue compress always fails: surfaceOp { op:"replace", start/end } rejected by dsh-session >= 0.1.3 (needs startSeq/endSeq) #136)
• report the nudge context breakdown from the live surface, not the compressed-away log total ((fix) nudge context breakdown: report the live surface, not the compressed-away log total #140)
• keep block-ledger fields inside rawOutput so pre-upgrade session logs stay openable ((bug) compaction/summary persists non-format members (tier/topic/kernelBlockId/…) — pre-2.0.9 v0 session logs become unopenable after host upgrade #141 / (fix) persist block-ledger fields in rawOutput, not as top-level members — session logs stay openable after a host upgrade (#141) #142)

Chore

• acp-kernel 0.0.63 — the compressible-range geometry comes from the kernel again; the labeled drift workaround is removed ((chore) bump acp-kernel to 0.0.63 — range table from the kernel (drift workaround removed) #122)

Test

• pin cross-turn outbound byte-stability (prompt-cache guard) ((test) pin cross-turn outbound byte-stability / prompt-cache guard (#111) #126)

Credits — merged PR authors, issue reporters, and the authors of superseded PRs:

• Merged PRs: @ranxianglei ((fix) page large-block decompress output with offset/limit so one recovery can't flood or get silently trimmed #118, (fix) bound per-session kernel-state and nudge-dedup caches with LRU eviction #121, (chore) bump acp-kernel to 0.0.63 — range table from the kernel (drift workaround removed) #122, (test) pin cross-turn outbound byte-stability / prompt-cache guard (#111) #126, (feat) one-word nudge presets via config.preset (five tiers) #129, (feat) hot-reload engine settings via settings.yaml + /acp config (phase 1; supersedes #76) #130, (fix) search_context: cache the block ledger and search corpus per log snapshot — 20-minute searches become sub-second #134, (fix) emit the renamed replace-op dialect for dsh-session 0.1.5+ and floor the peer range at 0.1.5 #137, (fix) persist block-ledger fields in rawOutput, not as top-level members — session logs stay openable after a host upgrade (#141) #142, (feat) frame model-written summaries, record verified readings, slim nudges (drop unchanged-injection elision) #143), @wszhoho ((fix) 切模型后 output cap 改从 session.requestContext 取实时路由 #135)
• Issue reports: @asc50314 (search_context 随压缩块累积而急剧变慢（从毫秒级劣化到 ~20 分钟）——疑似每调用 O(B²·N) 的账本重建 + 全量语料重复分词 #133 — the ~20-minute search report), @EkkoXy ((bug) compaction/summary persists non-format members (tier/topic/kernelBlockId/…) — pre-2.0.9 v0 session logs become unopenable after host upgrade #141), @hairyf (compress always fails: surfaceOp { op:"replace", start/end } rejected by dsh-session >= 0.1.3 (needs startSeq/endSeq) #136), @ranxianglei ([perf] rebuildBlockLedger/blockRegistry 未缓存，search/compress/nudge 内被循环 O(N) 重扫 #109, [test][caching] 缺跨轮出站字节稳定性 / prompt-cache 回归测试 #111, [bug][recall] decompress / /acp decompress 输出无上限、无分页 —— 大 block 恢复要么灌爆上下文,要么被宿主静默截断 #112, [multimodal] image block 在 ACP 投影层完全不可见:同一份 acp_status 两套标尺、range 表对图片区间记 0 token、图片-only 事件无 bare ref 且不受内核保护 #117)
• Superseded PRs (closed unmerged, but the diagnosis or attempt carried the eventual fix): @TheTouYu (feat: injection governance — summary source framing, unchanged-injection elision, verified readings, slim nudge #132), @hairyf ((fix) compress emits the current SurfaceOp protocol — startSeq/endSeq, not start/end (issue #136) #138), @wszhoho ((fix) 适配 dsh 0.1.5 的 surfaceOp 替换字段重命名并修正 nudge 上下文口径 #139), @ranxianglei (perf(region): memoize rebuildBlockLedger per snapshot to cut O(B^2*N) rebuilds (#109) #123)